package com.bookrecomm.dao;

import com.bookrecomm.entity.Category;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 分类数据访问接口
 * 提供图书分类相关的数据库操作方法
 */
@Repository
public interface CategoryRepository extends JpaRepository<Category, Long> {

    /**
     * 根据分类名称查找分类
     * @param name 分类名称
     * @return 分类对象（可能为空）
     */
    Optional<Category> findByName(String name);

    /**
     * 检查分类名称是否已存在
     * @param name 分类名称
     * @return 是否存在
     */
    boolean existsByName(String name);

    /**
     * 查询所有一级分类（parentId为null）
     * @return 一级分类列表
     */
    List<Category> findByParentIdIsNull();

    /**
     * 根据父分类ID查询子分类
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<Category> findByParentId(Long parentId);

    /**
     * 根据状态查询分类
     * @param status 状态（0-禁用，1-正常）
     * @return 分类列表
     */
    List<Category> findByStatus(Integer status);

    /**
     * 查询热门分类（根据关联图书数量）
     * @param limit 限制数量
     * @return 分类列表
     */
    @Query(value = "SELECT c.* FROM categories c " +
            "JOIN book_categories bc ON c.id = bc.category_id " +
            "WHERE c.status = 1 " +
            "GROUP BY c.id " +
            "ORDER BY COUNT(bc.book_id) DESC LIMIT :limit", nativeQuery = true)
    List<Category> findHotCategories(@Param("limit") int limit);

    /**
     * 查询分类树（按层级和权重排序）
     * @return 分类列表
     */
    @Query("SELECT c FROM Category c WHERE c.status = 1 ORDER BY c.level, c.weight DESC")
    List<Category> findCategoryTree();
    
    /**
     * 检查数据库表是否存在
     * @param tableName 表名
     * @return 表是否存在
     */
    @Query(value = "SELECT EXISTS(SELECT 1 FROM information_schema.tables WHERE table_schema = DATABASE() AND table_name = :tableName)", nativeQuery = true)
    Boolean existsTable(@Param("tableName") String tableName);
    
    /**
     * 查询数据库中分类表的记录数
     * @return 记录数
     */
    @Query(value = "SELECT COUNT(*) FROM categories", nativeQuery = true)
    Long countCategories();
}
